bizLib
bizLib was written to overcome the limited user interface of PocketC. bizLib is a Native Library that is written in CodeWarrior and is a programmer friendly wrapper around the Palm OS 3.0+ operating System
By using a combination of PocketC and bizLib the developer has available a very powerful set of tools for creating business level applications.
The features of bizLib are
- Forms / Dialogs
- Dynamic User Interface Objects
- InfraRed Printing without 3rd Party Products
- Serial Printing
- Date Functions
- System Functions
- Widgets
- Application Functions
- Small Footprint only 20K
- Embeddable into PocketC applications
Function List by Category
Library
zVersion();
zEndLib();
zLibReg(int TextArray);
Forms
zNewForm(string Title);
zShowForm();
zDialog(int Height, string Title);
zDialogEnd();
zEvent(int dummy);
zSetFont(int FontID);
zFormInfo(int FrmFunc);
CheckBox
zCheckBox(int x, int y, int width, int height, string Caption);
zBtnStyle(int BoxStyle, int RightAlign);
zStartGrp();
zEndGrp();
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zGetValue(int resourceID);
zSetValue(int resourceID, int Value);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);
Selector
zSelector(int x, int y, int width, int height, string Caption);
zBtnStyle(int BoxStyle, int RightAlign);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);
Buttons
zButton(int x, int y, int width, int height, string Caption);
zBtnStyle(int BoxStyle, int RightAlign);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);
Push Buttons
zPButton(int x, int y, int width, int height, string Caption);
zBtnStyle(int BoxStyle, int RightAlign);
zStartGrp();
zEndGrp();
zGetValue(int resourceID);
zSetValue(int resourceID, int Value);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);
Repeater Button
zRButton(int x, int y, int width, int height, string Caption);
zBtnStyle(int BoxStyle, int RightAlign);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);
Lists
zList(int x, int y, int width, int lines, int 0);
zAddArray(int resourceID ,int TextArray, int ItemCnt);
zAddItem(int resourceID, string ListItem);
zFinList(int resourceID, int SortOrder);
zClearList(int resourceID);
zGetText(int resourceID);
zGetValue(int resourceID);
zSetValue(int resourceID, int Value);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);
DropDown Lists
zPopTrig(int x, int y, int width, int height, string Caption);
zList(int x, int y, int width, int lines, int triggerID);
zAddArray(int resourceID ,int TextArray, int ItemCnt);
zAddItem(int resourceID, string ListItem);
zFinList(int resourceID, int SortOrder);
zClearList(int resourceID);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zGetValue(int resourceID);
zSetValue(int resourceID, int Value);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);
PopUp Lists
zList(int x, int y, int width, int lines, int 100);
zPopList(int resourceID);
zAddArray(int resourceID ,int TextArray, int ItemCnt);
zAddItem(int resourceID, string ListItem);
zFinList(int resourceID, int SortOrder);
zClearList(int resourceID);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zGetValue(int resourceID);
zSetValue(int resourceID, int Value);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);
Fields
zEdit(int x, int y, int width, int Lines, int MaxChars, string Text);
zEditStyle(int editable, int underline, int align, int ValidChars);
zAddrLookup(int resourceID);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);
zCut();
zCopy();
zPaste();
Labels
zLabel(int x, int y, string Caption);
zCLabel(int x, int y, string Caption);
zRLabel(int x, int y, string Caption);
Widgets
zProgBar(int value);
zWaitBox(int state);
Date
zSelDate(int yyyymmdd, string Title);
zDateInfo(int DateValue, int FmtFunc);
System
zAutoOff(int delay);
zBackLight(int State);
zSysInfo(int InfoPtr);
Printing
zIrPrint(int TextArray, int ItemCnt);
zSerPrint(int TextArray, int ItemCnt);
Other
zGetPref(string CreatorID, int Item);
zSetPref(string CreatorID, int Item, string Settings);
Function Reference
zAddArray(int resourceID ,int TextArray, int ItemCnt);
Parameters
int resourceID
ID of a List Object returned from a zList function call
int TextArray
Name of a populated PocketC string array
int ItemCnt
Count of the number of items that you wish to copy to the list box
Purpose
To append the contents of a populated PocketC string array to the end of a Form List Object
Returns
Nothing
Comments
zAddItem(int resourceID, string ListItem);
Parameters
int resourceID
ID of a List Object returned from a zList function call
string ListItem
Name of a PocketC string
Purpose
To append the contents of a PocketC string to the end of a Form List Object
Returns
Nothing
Comments
zAddrLookup(int resourceID);
Parameters
int resourceID
an Id returned from a zEdit function call
Purpose
Call the Address Book Application to look up a phone number
When trying to match a field, this function first tries to match
selected textIf there is some selected text, the function replaces it with the phone number if there is a match. If there is no selected text, the function replaces the text in which the insertion point is with the phone number if there is a match. If there is no match, the function displays the Address Book short list.
Returns
Nothing
Comments
zAutoOff(int delay);
Parameters
int delay
number of seconds to delay until auto timer turns the Palm Device off
Purpose
Set the time out value in seconds for auto-power-off. (0) zero means never power off
Returns
Previous setting of the Auto Off Timer
Comments
zBackLight(int State);
Parameters
int state
0 turns the backlight off 1 turns the backlight on Purpose
Turns the backlight on or off
Returns
Nothing
Comments
zBtnStyle(int BoxStyle, int LeftAnchor);
Parameters
int BoxStyle
0 no Button Frame 1 standard Button Frame 2 bold Button Frame 3 rectangleButtonFrame Affects Buttons & Repeater Buttons
int LeftAnchor
true Locks the control's left co-ordinates false Locks the controls right Coordinates Affects Selector, Checkbox & Popup trigger.
Purpose
To alter the default display settings of buttons
All further calls to zButton, zSelector & zRButton will use the new attributes until reset or a zNewForm function call is performedReturns
Nothing
Comments
zButton(int x, int y, int width, int height, string Caption);
Parameters
int x
Position of Button in pixels, 1 - 160, from left to right
int y
Position of Button in pixels 1 - 160, from top to bottom
int width
Width of Button in pixels, if 0 (zero) then the bizLib determines width of Button based upon Caption string
int height
Height of Button in pixels, if 0 (zero) then the bizLib determines height of Button based upon current Form font, see zSetFont
string Caption
Caption of Button, this is the initial text, it may be altered later with zSetText
Purpose
Place a Button Control onto the current Form
Returns
The resourceID of the newly created Button, this will be needed for use with function calls and event processing
Comments
zCheckBox(int x, int y, int width, int height, string Caption);
Parameters
int x
Position of CheckBox in pixels, 1 - 160, from left to right
int y
Position of CheckBox in pixels 1 - 160, from top to bottom
int width
Width of CheckBox in pixels, if 0 (zero) then the bizLib determines width of CheckBox based upon Caption string
int height
Height of CheckBox in pixels, if 0 (zero) then the bizLib determines height of CheckBox based upon current Form font, see zSetFont
string Caption
Caption of Checkbox, this is the initial text, it may be altered later with zSetText
Purpose
Place a CheckBox Control onto the current Form
Returns
The resourceID of the newly created Checkbox, this will be needed for use with function calls and event processing
Comments
zClearList(int resourceID);
Parameters
int resourceID
the resource id returned from a zList function call
Purpose
Clears the contents of a Form ListBox, and releases the memory allocated to the ListBox contents
Returns
Nothing
Comments
zCopy();
Parameters
None
Purpose
Copies the selected text in an EditField control into the clipboard
Returns
Nothing
Comments
zCut();
Parameters
None
Purpose
Places the selected text in an EditField control into the clipboard and then erases the selected text from the EditField
Returns
Nothing
Comments
zDateInfo(int DateValue, int FmtFunc);
Parameters
int DateValue
Date in YYYYMMDD format or days since 1904
int FmtFunc
Function number to request date type, each function return information in various formats.
Func Returns Details 0 integer YYYYMMDD 1 string Short Date Format as specified in Prefs / Formats 2 string Long Date Format as specified in Prefs / Formats 3 string Short Day of Week - Sun, Mon, Tue ..... 4 string Long Day of Week - Sunday, Monday, Tuesday .... 5 string Short Months - Jan, Feb, Mar, ..... 6 string Long Months - January, February, March .... 7 integer Year in YYYY 8 integer Month in MM 9 integer Day in DD 10 integer Day of Week, 0 = Sunday, 1 = Monday .. 11 integer Days in the Month 12 integer Day of Month, ie. 3rd Tuesday in month ... 13 integer Days since 1st Jan 1904 Purpose
Return information about a given date in various formats
Returns
Refer above for format types
Returns -1 if an incorrect format is passed
With this function it is possible to calculate days between dates, add days to dates and most other date calculations.Comments
zDialog(int Height, string Title);
zDialogEnd();Parameters
int Height
Height of the Dialog Window in pixels, the window will be positioned at the bottom of the screen
string Title
Text to be displayed in the top middle of the window in inverse text
Purpose
Creates a dialog window so that the main form is not altered of affected by the new form activity.
There can only be 1 (one) dialog form, there is no error trapping for this in the Library so careful attention to the PocketC program is required
Any type of control may be placed onto the Dialog Form
Use zEvent to interact with the FormReturns
nothing
Comments
zEdit(int x, int y, int width, int Lines, int MaxChars, string Text);
Parameters
int x
Position of EditField in pixels, 1 - 160, from left to right
int y
Position of EditField in pixels 1 - 160, from top to bottom
int width
Width of EditField in pixels.
int height
height of EditField in lines of text, bizLib determines height of EditField based upon current Form font, see zSetFont if height equals 1 (one) the EditField is a single line edit if height is greater than 1 then the EditField will be drawn with scroll arrows at the right of the EditField and the user may enter information including newlines, newlines are counted as a character within the MaxChars limit
int MaxChars
The maximum number of characters that a user may enter into the EditField, including newlines
string Text
The initial text that will appear in the EditField ready for editing.
Purpose
Places an EditField onto a Form Allows the user to enter and edit textual information The standard graffiti shift indicator and autoshift rules apply keyboard popups work when cursor is within an EditField zCut, zCopy & zPaste all work with EditFields
Returns
Nothing
Comments
zEditStyle(int editable, int underline, int align, int ValidChars);
Parameters
int editable
true allows the user to edit the text in the EditField false displays the EditField iin ReadOnly mode int underline
true displays the EditField with a dotted underline as per PalmOS standard false display no underline int align
true Left Aligns the text in the EditField false right Aligns the text in the EditField int ValidChars
true allows any enterable character to be used false allows only number and the decimal point to be entered Purpose
To alter the display style of the EditField
All further calls to zEdit will use the new attributes until reset or a zNewForm function call is performedReturns
nothing
Comments
zEndGrp();
Parameters
None
Purpose
End the grouping of Push Buttons and Checkboxes
Returns
Nothing
Comments
zEndLib();
Parameters
None
Purpose
Must be called when finished using the Form Functions of the bizLib library
Releases all memory allocated to the Form objects
Restores PocketC back to normal configurationReturns
Nothing
Comments
zEvent(int dummy);
Parameters
int dummy
Reserved for future use
Currently the only option available is 1 (one) i.e. Indefinite waitPurpose
Allows interaction with the Form
When a zEvent function is called the process will wait indefinitely for user input into the Form. The zEvent function returns whenever any of the following is selected:Any Button Type
A Popup Trigger
A CheckBox
A Selector
An item in a ListBox
The Silk Screen Menu
The Title BarReturns
The resourceID of the selected item
The value 9999 is returned when the Title Bar or the Silk Screen Menu is selectedComments
zFinList(int resourceID, int SortOrder);
Parameters
int resourceID
a resourceID returned from a zList function call
int SortOrder
Sorts the content of the ListBox
0 Do not Sort 1 Sort in Ascending Order 2 Sort in Descending Order Purpose
Finalizes the contents of a Forms ListBox and redraws it on the Form if the ListBox is already visible
this function must be called once the programmer has finished with zAddArray and zAddItem function calls to populate the Form ListBox
this function may be called any number of times if the programmer wishes to keep appending to the ListBox at a later stage
this function may be called any number of times if the programmer wishes to change the sort order displayed in the ListBoxReturns
Nothing
Comments
zFormInfo(int FormFunc);
Parameters
int FormFunc
0 FontID 1 Button Frame style 2 Button Alignment style 3 EditField Editable style 4 EditField Underline style 5 EditField Alignment style 6 EditField ValidChars style Purpose
Returns information on the current style as set by zNewForm, zEditStyle, zBtnStyle and zSetFont
Returns
See Parameters
Comments
zGetPref(string CreatorID, int Item);
Parameters
string CreatorID
A Palm Creator ID, this must be registered with Palm and must be unique to your application
Int Item
Item number of the application preference
Purpose
To retrieve the application preferences from the Saved Preferences system
See zSetPref for further detailsReturns
Application preference
Comments
zGetText(int resourceID);
Parameters
int resourceID
a resourceID returned from a call to one of the following Functions
zButton
zPButton
zRButton
zPopTrig
zList
zSelector
zCheckBox
zEdit
Purpose
Retrieves the text allocated to the nominated resource.
Returns
Buttons will return the current Caption text
EditFields will return the contents of the EditField
Popup Triggers will return the current Caption text
ListBoxes will return the currently select Item Text
Selectors will return the current Caption text
CheckBoxes will return the current Caption textComments
zGetValue(int resourceID);
Parameters
int resourceID
a resourceID returned from a call to one of the following Functions
zPButton
zList
zCheckBox
Purpose
Retrieves the current value of the nominated resource.
Returns
Push Buttons will return the current state - selected (1) or deselected (0)
ListBoxes will return the currently select Item - the first item is 0 (zero)
CheckBoxes will return the current state - checked (1) or unchecked (0)Comments
zIrPrint(int TextArray, int ItemCnt);
Parameters
int TextArray
A PocketC String Array
int ItemCnt
The number of array items to print
Purpose
Prints the contents of a PocketC String Array to a Infrared Printer
Returns
0 Successful -1 User cancelled the operation -2 Timeout Occurred, currently this is 30 Seconds per operation Comments
zIsVisible(int resourceID);
Parameters
int resourceID
A resource Id returned from creating any new Form Object, e.g. zButton
Purpose
Returns information on whether a control is visible or not
Returns
0 is NOT visible -1 is currently visible Comments
zLabel(int x, int y, string Caption);
zCLabel(int x, int y, string Caption);
zRLabel(int x, int y, string Caption);Parameters
int x
Position of Label in pixels, 1 - 160, from left to right
int y
Position of Label in pixels 1 - 160, from top to bottom
string Caption
Caption of Label, this is the only way to set the text, it may NOT be altered later
Purpose
to place text labels onto the Form
Returns
Nothing
Comments
The values of x and y have different meaning depending on whick label function you choose.
zLabel - x & y are the coordinates of the top left of the label
zCLabel - x & y are the coordinates of the center top of the label
zRLabel - x & y are the coordinates of the top right of the labelThese functions make it easy to place labels on the Form with left, centered or right alignment.
zLibReg(int TextArray);
Parameters
int TextArray
A PocketC string array of 9 elements containing the About Popup Form information for your application
Purpose
To fill the about box with information about your application. This about box is shown when the user selects the © in the bottom right of the form.
Returns
0 registration successful -1 registration failed Comments
string aReg[9]; aReg[0] = "zEditStyle Program"; aReg[1] = ""; aReg[2] = "Author: Stewart Whiteside"; aReg[3] = "CopyRight: Me"; aReg[4] = ""; aReg[5] = "http://myWebSite.com"; aReg[6] = ""; aReg[7] = ""; aReg[8] = ""; zLibReg(aReg);
zList(int x, int y, int width, int lines, int triggerID);
Parameters
int x
Position of ListBox in pixels, 1 - 160, from left to right
int y
Position of ListBox in pixels 1 - 160, from top to bottom
int width
Width of ListBox in pixels.
int height
Height of ListBox in lines of text, bizLib determines height of ListBox based upon current Form font, see zSetFont
if the number of items in the ListBox exceeds this value then scroll arrows will be drawn at the right of the ListBox and the user may scroll up or down the Listbox to select the desired informationint triggerID
0 Places the ListBox on the current Form and is visible when the Form is displayed 100 Places the ListBox on the current Form and only becomes visible with the zPopList function call
then the ListBox only remains visible until the users next interface event
ie. If the user selects an item from the ListBox or taps the screen somewhere outside the ListBox.PopTrigID A resource ID returned from a zPopTrig function call, this creates a DropDownListBox style control.
Places the ListBox on the current Form and only becomes visible when the
user selects the nominated Popup Trigger controlPurpose
to place various forms of ListBoxes controls on the Form
Returns
nothing
Comments
zNewForm(string Title);
Parameters
string Title
Title of new Form, This string will display in inverse text at the top left of the new Form.
Purpose
Create a new Form on which to place controls, Edit Fields, Lists etc.
This Form is independent of the PocketC Graphics Forms and the Output Form, ie. All these forms can be used independently.
The zNewForm function performs the following tasks.Deletes any previous Form created with zNewForm and releases all allocated memory. Set the Font to StandardFont Resets all Lists Sets the Field Attributes to Editable, Underline, LeftAlign & AlphaNumeric character input, see zEditStyle Sets the Button Attributes to StandardBorder and Left Anchor, see zBtnStyle Creates the new Form with the title passed to it when invoked
Returns
Nothing
Comments
zPaste();
Parameters
None
Purpose
Pastes the text in the clipboard into the selection point of an EditField
Returns
Nothing
Comments
zPButton(int x, int y, int width, int height, string Caption);
Parameters
int x
Position of PushButton in pixels, 1 - 160, from left to right
int y
Position of PushButton in pixels 1 - 160, from top to bottom
int width
Width of PushButton in pixels, if 0 (zero) then the bizLib determines width of PushButton based upon Caption string
int height
Height of PushButton in pixels, if 0 (zero) then the bizLib determines height of PushButton based upon current Form font, see zSetFont
string Caption
Caption of PushButton, this is the initial text, it may be altered later with zSetText
Purpose
Place a PushButton Control onto the current Form
Returns
The resourceID of the newly created PushButton, this will be needed for use with function calls and event processing
Comments
zPopList(int resourceID);
Parameters
int resourceID
a resourceID returned from a zList function call
Purpose
To display a ListBox object that was created with the zList function call with a triggerID of 100
Returns
0 thru to ItemCount - 1
The user selected item value from the displayed list 0 (zero) is the first item in the ListBox
-1 is returned if no item selectedComments
zPopTrig(int x, int y, int width, int height, string Caption);
Parameters
int x
Position of PopupTrigger in pixels, 1 - 160, from left to right
int y
Position of PopupTrigger in pixels 1 - 160, from top to bottom
int width
Width of PopupTrigger in pixels, if 0 (zero) then the bizLib determines width of PopupTrigger based upon Caption string
int height
Height of PopupTrigger in pixels, if 0 (zero) then the bizLib determines height of PopupTrigger based upon current Form font, see zSetFont
string Caption
Caption of PopupTrigger, this is the initial text, it may be altered later with zSetText
Purpose
Place a PopupTrigger Control onto the current Form
Returns
The resourceID of the newly created PopupTrigger, this will be needed for use with function calls and event processing
Comments
zProgBar(int value);
Parameters
int Value
The value of progress bar to display between -1 and 100
-1 turns the progress bar window off
1 thru 100 displays the progress bar with a pattern bar to indicate progress madePurpose
To display a progress bar window that informs the user that some action is being performed by the program that may take some time, gives the user some positive feedback that the program has not unexpectedly stopped.
Returns
Nothing
Comments
zRButton(int x, int y, int width, int height, string Caption);
Parameters
int x
Position of RepeatButton in pixels, 1 - 160, from left to right
int y
Position of RepeatButton in pixels 1 - 160, from top to bottom
int width
Width of RepeatButton in pixels, if 0 (zero) then the bizLib determines width of RepeatButton based upon Caption string
int height
Height of RepeatButton in pixels, if 0 (zero) then the bizLib determines height of RepeatButton based upon current Form font, see zSetFont
string Caption
Caption of RepeatButton, this is the initial text, it may be altered later with zSetText
Purpose
Place a RepeatButton Control onto the current Form
Returns
The resourceID of the newly created RepeatButton, this will be needed for use with function calls and event processing
Comments
zSelDate(int yyyymmdd, string Title);
Parameters
int yyyymmdd
A numeric date in YYYYMMDD format, this will be the starting date when the Date Selection Window pops up
string Title
A PocketC string that will appear in the Title Bar of the Date Selection Window
Purpose
To enable easy selection of dates
Returns
The selected date in YYYYMMDD format
-1 if the user cancels the selectionComments
zSelector(int x, int y, int width, int height, string Caption);
Parameters
int x
Position of Selector in pixels, 1 - 160, from left to right
int y
Position of Selector in pixels 1 - 160, from top to bottom
int width
Width of Selector in pixels, if 0 (zero) then the bizLib determines width of Selector based upon Caption string
int height
Height of Selector in pixels, if 0 (zero) then the bizLib determines height of Selector based upon current Form font, see zSetFont
string Caption
Caption of Selector, this is the initial text, it may be altered later with zSetText
Purpose
Place a Selector Control onto the current Form
Returns
The resourceID of the newly created Selector, this will be needed for use with function calls and event processing
Comments
zSerPrint(int TextArray, int ItemCnt);
Parameters
int TextArray
a PocketC String Array
int ItemCount
the number of array items to print
Purpose
Prints the contents of a PocketC String Array to a Serial Device
Returns
0 Successful -1 User cancelled the operation -2 Timeout Occurred, determined by seropen settings Comments
This function must be used in conjunction with the PocketC functions
seropen and sercloseFirst, open the serial port with the desired parameters
Second, issue the zSerPrint function with the populated array
Third, close the serial port
zSetPref(string CreatorID, int Item, string Settings);
string CreatorID
A Palm Creator ID, this must be registered with Palm and must be unique to your application
Int Item
Item number of the application preference
Purpose
To retrieve the application preferences from the Saved Preferences system
Returns
Application preference
Comments
zSetFont(int FontID);
Parameters
int FontID
the selected FontID for the next operation, affects all controls
0 stdFont 1 boldFont 2 largeFont 7 largeBoldFont 3 symbolFont 4 symbol11Font 5 symbol7Font 6 ledFont Purpose
To select a nominated font for all subsequent new controls
The font is reset back to stdFont with the next zNewForm function callReturns
Nothing
Comments
zSetText(int resourceID, string Text);
Parameters
int resourceID
a resourceID returned from a call to one of the following Functions
zButton
zPButton
zRButton
zPopTrig
zList
zSelector
zCheckBox
zEditstring Text
The new text string to set the control with
Purpose
Sets the text allocated to the nominated resource.
Returns
Nothing
Comments
zSetValue(int resourceID, int Value);
Parameters
int resourceID
A resourceID returned from a call to one of the following Functions
zPButton
zList
zCheckBoxint Value
The value with which to set the nominated control
0 or 1 for PushButtons, 1 sets the PushButton, 0 clears it
0 or 1 for CheckBoxs, 1 checks the checkbox, 0 unchecks itlistBoxes - the value will select that item in the Listbox, 0 is the first item, if the ListBox is displayed then the item will become visible in the ListBox and will be indicated selected.
Purpose
Sets the current value of the nominated resource.
Returns
Nothing
Comments
zShowForm();
Parameters
None
Purpose
To display the current form or dialog, ready for user interaction
After a zShowForm call is issued then no further object may be created for that formReturns
Nothing
Comments
zStartGrp();
Parameters
None
Purpose
Start the grouping of Push Buttons and CheckBoxs.
Returns
Nothing
Comments
each group allows the controls to automatically react with other controls in the the same group, this allows multiple groups of PushButtons and CheckBoxs to be placed on the same form.
zSysInfo(int funct);
Parameters
int funct
0 Operating System Version String 1 ROM Version 2 Product ID 3 remaining battery Volts 4 Type of Battery 5 is device plugged in plugged 6 Percentage of Battery remaining 7 Auto Off Timer Seconds 8 System Ticks Per Second Purpose
Returns the requested information about the system
Returns
Function Type Info example 0 string Operating System Version String "v.3.0." 1 string ROM Version
0xMMmfsbbb, where
MM is major version
m is minor version
f is bug fix
s is stage: 3-release,2-beta,1-alpha,0-development
bbb is build number for non-releases"01122003" 2 string Product ID
0xMMMMRRRR, where MMMM is the model and
RRRR is the revision."00000000" 3 int Battery Volts - current voltage * 100 250 = 2.5volts 4 int Type of Battery 0=Alkaline, 1=NiCad, 2=Lithium 1 5 int is device plugged in plugged 0=No, 1=Yes 0 6 int Percentage of Battery remaining 50 = 50% 7 int Auto Off Timer Secs 0=never turn off 0 8 int System Ticks Per Second 10 Comments
zVersion();
Parameters
None
Purpose
Retrieve the version number of the current bizLib
Returns
The version number in an integer format
10000 = Mmmbb where M=Major, mm=minor and bb=bugfixesComments
Current version is 1.00.00
zVisible(int resourceID, int State);
Parameters
int resourceID
A resourceID returned from a call to one of the following Functions
zButton
zPButton
zRButton
zPopTrig
zList
zSelector
zCheckBox
zEditint State
The new state with which you want to set the control
0 - hide the control
1 - show the controlPurpose
To hide and show controls on a Form
Returns
Comments
Only works if the form is showing use zShowForm();
zWaitBox(int state);
Parameters
int state
0 - hide the WaitBox window
1 - show the WaitBox windowPurpose
Shows or hides a Wait Window
Returns
Nothing
Comments
Gives the user positive feedback that the delay is programmed for